home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / commions / ca29_1 / ca29_3.exe / SCRIPTS.DOC < prev    next >
Text File  |  1992-11-30  |  15KB  |  398 lines
  1. -------------------------------------------------------------------------------
  2. 921118                COM-AND Scripts             Page  1
  3. -------------------------------------------------------------------------------
  4. Included in CA29-3.ZIP (the version 2.9 release of COM-AND) are:
  5. -------------------------------------------------------------------------------
  6.  
  7. ALARM.CMD
  8.  
  9.    ALARM is pop-up window script that sets COM-AND's alarm tune from one of
  10.    several selections.    It also demonstrates the steps to take to customize
  11.    your own alarm.
  12.  
  13. ANSI.CMD
  14. ANSI.HLP (also a script)
  15.  
  16.    ANSI enables ANSI display emulation, AND creates enables a keyboard
  17.    remap emulating ANSI X3.64 keyboard keys.  Note that the file COM-AND.RMP
  18.    is replaced.  REMAPS.TXT contains the source for the remap.    ANSI.HLP
  19.    replaces the F10 help (if ANSI.HLP is installed).
  20.  
  21. BBS.CMD
  22. BBS.SRC
  23. BBS.DOC
  24. BBMAINT.CMD        (New) Maintenance script for the BBS
  25. BBMAINT1.CMD        (New) BBMAINT extension script (users)
  26. BBMAINT2.CMD        (New) BBMAINT extension script (files)
  27. BBMAINT3.CMD        (New) BBMAINT extension script (bulletins)
  28. BBMAINT4.CMD        (New) BBMAINT extension script (mail)
  29. BBSETUP.CMD        (New) Setup script for the BBS
  30.  
  31.    BBS.CMD is a full fledged bulletin board script, with mail (public and
  32.    private), file area, and bulletins.    Run the SETUP script before use.
  33.    BBS.SRC is the source with comments.  BBS.CMD is the script stripped of
  34.    comments.  BBS.DOC documents the use of BBS, BBMAINT, and BBSETUP.
  35.  
  36. BIX.CMD
  37.  
  38.    BIX is a simple script to dial the BIX service (through TYMNET, directory
  39.    entry 9), and initiate connection.  [See note below on autologon.]
  40.  
  41. BREAKOUT.CMD
  42.  
  43.    BREAKOUT is a demonstration of the script language.    It plays a simple
  44.    'breakout' style game.  Paddle control is through the cursor keys or a
  45.    mouse (if supported).
  46.  
  47. CIS.CMD
  48.  
  49.    CIS is a simple script to dial the CIS service (using dialing directory
  50.    entry 3), and initiate connection.  [See the note below on autologon.]
  51.  
  52.  
  53. -------------------------------------------------------------------------------
  54. 921118                COM-AND Scripts             Page  2
  55. -------------------------------------------------------------------------------
  56.  
  57. CONALARM.CMD
  58.  
  59.    CONALARM is a very simple script, that awaits receipt of a message (any
  60.    text).  The alarm is sounded when a line is received (and terminates).
  61.    It may be used waiting for someone else to enter a conversational area.
  62.  
  63. CONNECT.CMD
  64.  
  65.    CONNECT is a simple script to put COM-AND into auto-answer mode and
  66.    await a call.  When a connection is made, the script adjusts the line
  67.    speed appropriately, and opens a chat window.
  68.  
  69. DD.CMD
  70.  
  71.    DD searches the current subdirectory (and COM-AND= subdirectory) to present
  72.    a menu of dialing directories (*.DIR).  Select a directory to be opened.
  73.  
  74. DELPHITN.CMD
  75. DELPHISN.CMD
  76.  
  77.    DELPHI is a simple script to dial the Delphi service (through TYMNET (TN),
  78.    or SprintNet (SN)), and initiate connection.  [See note below on autologon.]
  79.  
  80. DIAL.CMD
  81.  
  82.    DIAL is a script emulation of the Alt-R redial window.  The number to be
  83.    dialed is NOT limited to 14 characters... and LD codes may not be used.
  84.  
  85. DIALER.CMD
  86.  
  87.    DIALER is a script providing a multi-dialer.  Up to 10 dialing directory
  88.    numbers may be specified.  The numbers are dialed one after another until
  89.    a connection is made.  The list of numbers (less the one just connected)
  90.    is saved on disk for next use.
  91.  
  92. DOORWAY.CMD
  93.  
  94.    DOORWAY is a script invoking Marshall Dudley's DOORWAY (or a Doorway-like)
  95.    utility.  The first statement in the file specifies the invocation of the
  96.    utility; edit it to suit your installation.
  97.  
  98. DSZDOWN.CMD
  99.  
  100.    DSZDOWN is a script to invoke Chuck Forsberg's DSZ to download (it is set
  101.    to use YMODEM protocol, but may be changed)..
  102.  
  103. DSZUP.CMD
  104.  
  105.    DSZDOWN is a script to invoke Chuck Forsberg's DSZ to upload (it is set
  106.    to use YMODEM protocol, but may be changed).
  107.  
  108.  
  109. -------------------------------------------------------------------------------
  110. 921118                COM-AND Scripts             Page  3
  111. -------------------------------------------------------------------------------
  112.  
  113. FILEMGR.CMD
  114. FILEMGR.DOC
  115.  
  116.    FILEMGR provides useful file management functions through COM-AND.  It
  117.    may be used while on-line or offline.
  118.  
  119. FINDNAME.CMD
  120.  
  121.    FINDNAME searches through all dialing directory entries and all scripts
  122.    on the default drive for matching text.  If a dialing entry is found, the
  123.    number is dialed.  If a script is found, it is executed.
  124.  
  125. GENIE.CMD
  126.  
  127.    GENIE is a simple script that dials the GEnie service (using dialing
  128.    directory entry 4), and provides a masked password prompt.  [See note
  129.    below on autologon.]
  130.  
  131. HOST.CMD
  132. HOST.SRC
  133. HOST.DOC
  134. HOSETUP.CMD        (New) Setup script for the HOST
  135. HOSTART.CMD        (New) Restart script for the HOST and doorway
  136.  
  137.    HOST provides a limited host mode for file transfers.  Run the SETUP
  138.    script before use.  HOST.SRC is the script with comments.  HOST.CMD is
  139.    the script without comments.  HOST.DOC documents the HOST, HOSETUP and
  140.    HOSTART scripts.
  141.  
  142. INDIR.CMD
  143.  
  144.    INDIR reads an ASCII file (of a fixed format, documented in the script)
  145.    creating a new dialing directory file.  Compatible with OUTDIR below.
  146.  
  147. KERDOWN.CMD
  148.  
  149.    KERDOWN is a script to invoke Jan van der Eyjk's PCKERMIT to download.
  150.  
  151. KERMSERV.CMD
  152.  
  153.    KERMSERV is a script providing KERMIT server commands for systems (such
  154.    as the SOURCE) where they're useful.  It implements SEND/RECEIVE/FINISH
  155.    and LOGOUT functions.
  156.  
  157. KERUP.CMD
  158.  
  159.    KERUP is a script to invoke Jan van der Eyjk's PCKERMIT to upload.
  160.  
  161.  
  162. -------------------------------------------------------------------------------
  163. 921118                COM-AND Scripts             Page  4
  164. -------------------------------------------------------------------------------
  165.  
  166. LEARN.CMD
  167. LEARN.DOC
  168. LEARN.SRC
  169.  
  170.    LEARN follows actions performed, such as dialing, responding to prompts,
  171.    and so on, and creates a script to perform the same actions.  LEARN.DOC
  172.    documents the function of LEARN and its limitations.
  173.  
  174. LISTER.CMD
  175.  
  176.    LISTER is a script to listing an ASCII file to the screen with pagination.
  177.    Paging (backward limit 20 pages), Home, End, and FIND <str> are supported.
  178.  
  179. MCI.CMD
  180.  
  181.    MCI is a simple script to dial the MCI service (dialing directory entry
  182.    number 6), and initiate connection.    [See note below on autologon.]
  183.  
  184. MDMDIAG.CMD
  185.  
  186.    MDMDIAG is a diagnostic for the serial port currently opened by COM-AND.
  187.    It displays the values of various port registers for review.
  188.  
  189. MKLOGON.CMD
  190.  
  191.    MKLOGON creates a LOGON file appropriate for CIS, GENIE, UNISON or PLINK
  192.    (PLINK is now defunct) scripts.  MKLOGON optionally encrypts the new LOGON
  193.    file for security.
  194.  
  195. OUTDIR.CMD
  196.  
  197.    OUTDIR creates an ASCII file (named DIALING.TXT, documented in the script)
  198.    from the current dialing directory file.  Compatible with INDIR above.
  199.  
  200. PC-2-PC.CMD
  201. PC-2-PC.DOC
  202.  
  203.    PC-2-PC is a file transfer script for 2 PCs running COM-AND and linked
  204.    through either modem or direct wire.  PC-2-PC provides a convenient
  205.    display of subdirectories on both machines.    PC-2-PC.DOC documents the
  206.    script more thoroughly.
  207.  
  208. REMAP.CMD
  209. REMAP.DOC
  210. REMAPS.TXT
  211.  
  212.    REMAP compiles a source file of keyboard remapping for COM-AND.  The
  213.    REMAP.DOC describes the function and its uses.  REMAPS.TXT is an ASCII
  214.    file containing sample remaps for various terminal emulations.
  215.  
  216.  
  217. -------------------------------------------------------------------------------
  218. 921118                COM-AND Scripts             Page  5
  219. -------------------------------------------------------------------------------
  220.  
  221. SCRDUMP.CMD
  222.  
  223.    SCRDUMP appends the current screen text (25 or 43/50 lines) to the file
  224.    COM-AND.SCR on the current directory.  A top-of-form is added at the end
  225.    of the screen (to delimit multiple screens).
  226.  
  227.  
  228. SETTIME.CMD
  229.  
  230.    SETTIME dials the U.S.  Naval Observatory, and sets the DOS clock with the
  231.    correct time.  You must modify this script before use!  Read comments at
  232.    the beginning of the script.
  233.  
  234. SPRINT.CMD    (was TELENET.CMD originally)
  235.  
  236.    SPRINT is a simple script that dials SPRINT (dialing directory entry 10)
  237.    and performs basic connect commands.  It is FCALLed by other scripts,
  238.    here, and may be used alone as well.
  239.  
  240. STRIPPER.CMD
  241.  
  242.    STRIPPER strips an input script file of comments and extra spaces.
  243.    STRIPPER takes a while to execute, but stripped scripts do run faster.
  244.    NOTE: CACMP has subsumed this function, performing faster and more fully.
  245.  
  246. TTY.CMD
  247.  
  248.    TTY disables emulation, and disables keyboard remapping.
  249.  
  250. TYMNET.CMD
  251.  
  252.    TYMNET is a simple script that dials TYMNET (dialing directory entry 9)
  253.    and performs basic connect commands.  It may be FCALLed or used alone.
  254.  
  255. UARTTYPE.CMD
  256.  
  257.    URGENT determines the type of UART COM-AND finds on the default port.
  258.  
  259. UNISON.CMD
  260.  
  261.    UNISON is a simple script to dial the UNISON service (through SPRINT; it
  262.    uses dialing directory entry 10), and initiate connection.  [See note
  263.    below on autologon.]  Note:    SPRINT.CMD is required.
  264.  
  265. URGENT.CMD
  266.  
  267.    URGENT is a demonstration of INPUT and OUTPUT instructions in a script.
  268.    It sounds a wailing alarm.  [It is CPU speed dependant.]
  269.  
  270.  
  271. -------------------------------------------------------------------------------
  272. 921118                COM-AND Scripts             Page  6
  273. -------------------------------------------------------------------------------
  274.  
  275. VT100.CMD
  276. VT100.HLP (also a script)
  277.  
  278.    VT100 enables VT100 display emulation, AND creates enables a keyboard
  279.    remap emulating a VT100 keyboard.  Note that the file COM-AND.RMP is
  280.    replaced.  REMAPS.TXT contains the source for the remap.  VT100.HLP
  281.    replaces the F10 help (if VT100.HLP is installed).
  282.  
  283. VT52.CMD
  284. VT52.HLP (also a script)
  285.  
  286.    VT52 enables VT52 display emulation, AND creates enables a keyboard
  287.    remap emulating a VT52 keyboard.  Note that the file COM-AND.RMP is
  288.    replaced.  REMAPS.TXT contains the source for the remap.  VT52.HLP
  289.    replaces the F10 help (if VT52.HLP is installed).
  290.  
  291. XLATE.CMD
  292.  
  293.    XLATE prepares in and out character translation tables for COM-AND.    Please
  294.    refer to COM-AND.DOC for details of character translation in COM-AND.
  295.  
  296.  
  297. -------------------------------------------------------------------------------
  298. 921118                COM-AND Scripts             Page  7
  299. -------------------------------------------------------------------------------
  300. Script notes:
  301. -------------------------------------------------------------------------------
  302.  
  303.    As noted above, certain scripts require a dialing directory entry to be
  304.    set before the script is useful.  The following scripts assume:
  305.  
  306.     BIX.CMD     (uses TYMNET.CMD)    BIX through Tymnet
  307.     CIS.CMD     Directory entry 3    CIS direct dial
  308.     DELPHITN.CMD    (uses TYMNET.CMD)    Delphi through Tymnet
  309.     DELPHISN.CMD    (uses SPRINT.CMD)    Delphi through SprintNet
  310.     GENIE.CMD    Directory entry 4    GEnie direct dial
  311.     MCI.CMD     Directory entry 6    MCI direct dial
  312.     UNISON.CMD    (uses SPRINT.CMD)    Unison through SprintNet
  313.     SPRINT.CMD    Directory entry 10    Sprint (was Telenet) access
  314.     TYMNET.CMD    Directory entry 9    TYMNET access
  315.  
  316.  
  317.    Scripts may hard code telephone numbers as well.  In this collection, the
  318.    one scripts encodes a telephone number (and settings):
  319.  
  320.     SETTIME.CMD    Encodes U.S. Naval Observatory number
  321.  
  322.  
  323.    Scripts may be written to require the presence of other scripts.  The
  324.    scripts BIX, DELPHIxx and UNISON all require either SPRINT.CMD or TYMNET.
  325.    The following scripts may be used as subroutines (FCALLs):
  326.  
  327.     DIAL.CMD    Dial a long phone number
  328.     LISTER.CMD    List a file to the screen
  329.     SPRINT.CMD    Connect to SprintNet (Telenet)
  330.     TYMNET.CMD    Connect to Tymnet
  331.     URGENT.CMD    Sound a wailing alarm
  332.  
  333.  
  334.    The MKLOGON script creates LOGON files for BIX, CIS, DELPHI, GENIE, MCI,
  335.    and UNISON.    The BIX, CIS, DELPHI, GENIE, MCI, and UNISON scripts all all
  336.    look for an autologon script file.  If found, the autologon is executed.
  337.    If not found, the ALARM is sounded.    Each script looks for a certain file:
  338.  
  339.     BIX.CMD     looks for BIXLOGON.CMD    (or .ENF)
  340.     CIS.CMD     looks for CISLOGON.CMD    (or .ENF)
  341.     DELPHIxx.CMD    looks for DELLOGON.CMD    (or .ENF)
  342.     GEnie.CMD    looks for GENLOGON.CMD    (or .ENF)
  343.     MCI.CMD     looks for MCILOGON.CMD    (or .ENF)
  344.     UNISON.CMD    looks for UNILOGON.CMD    (or .ENF)
  345.  
  346.    The script MKLOGON creates the appropriate LOGON file, and may be used for
  347.    any of the systems above, at any time.
  348.  
  349.  
  350. -------------------------------------------------------------------------------
  351. 921118                COM-AND Scripts             Page  8
  352. -------------------------------------------------------------------------------
  353.  
  354.    With the exception of GENIE, the autologon file should take the form:
  355.  
  356.         TRANSMIT "yourID!"              ; The "!" is a carriage rtn
  357.         WAITFOR "password"              ; Wait for host prompt
  358.         TRANSMIT "yourPassword!"        ; The "!" is a carriage rtn
  359.         IF FCALLED FRET
  360.  
  361.    The GEnie autologon is just one TRANSMIT statement:
  362.  
  363.         TRANSMIT "ID,Password!"
  364.         IF FCALLED FRET
  365.  
  366.  
  367.    The autologon script may be created with any editor or wordprocessor cap-
  368.    able of creating an ASCII file (or non-document file).  It is NOT recom-
  369.    mended that you leave files containing ID and passwords unsecured.  COM-
  370.    AND may be used to encrypt the autologon file once created and tested, and
  371.    the original file put in a safe place.
  372.  
  373.  
  374.    COM-AND searches for script files both in the current directory and in
  375.    the subdirectory pointed to by the COM-AND= environment variable.  COM-AND
  376.    also tries the name you use with the extension ".CMD" and ".ENF".  Encryp-
  377.    tion is indicated within the encrypted file - not by the extension.    When
  378.    an encrypted script file is encountered COM-AND pops-up a window asking
  379.    for a decrypting password.  The script file is then decrypted as it is
  380.    executed.
  381.  
  382.    --------------------------------------------------------------------------
  383.    The following steps might be followed to create an autologon script file.
  384.  
  385.    1) Create the file as named above with the appropriate statements on the
  386.       subdirectory you've placed COM-AND and its scripts.
  387.  
  388.    2) Load COM-AND, and using F2, execute the outer script (CIS, GEnie, PLINK
  389.       or UNISON).  Assure yourself that the autologon script works correctly.
  390.  
  391.    3) After logging off, use Alt-N in COM-AND to encrypt the script.  For
  392.       example, the file CISLOGON.CMD could be encrypted to CISLOGON.ENF (the
  393.       name is important - the extension is not).  Remember the password you
  394.       used to encrypt the file!  Either encryption method may be used.
  395.  
  396.    4) After exiting COM-AND (or shelling to DOS), delete the original auto-
  397.       logon file (in the example above, delete be CISLOGON.CMD).
  398.